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ABSTRACT 


This  Portable,  Reusable,  Integrated  software  Modules  (PRISM)  Documentation  Library  User’s 
Guide  was  developed  under  the  Central  Archive  for  Reusable  Defense  Software  (CARDS) 
Program  to  help  disseminate  PRISM  documentation  and  knowledge.  It  represents  the  current 
state  of  the  PRISM  Documentation  Library  (PDL)  Model.  It  is  a  "living"  document  and  will  be 
updated  with  every  Library  release.  This  document  describes  the  method  needed  to  access  the 
PDL  Model. 

This  Guide  is  specific  to  PDL  Model  release  1.0.  The  intended  audience  is  anyone  desiring  an 
understanding  of,  or  wanting  access  to,  this  release  of  the  PDL  Model. 
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1  OVERVIEW 

This  PRISM  (Portable,  Reusable,  Integrated  Software  Modules)  Documentation  Library  (PDL) 
User’s  Guide  describes  how  to  access  the  PDL  Model  Release  1.0  (hereafter  referred  to  as 
"Model").  This  Guide  shows  users  the  method  needed  to  access  the  PDL,  and  as  such,  does  not 
go  into  great  detail  about  the  Library’s  design.  For  a  more  in-depth  view  of  the  library  model 
itself,  refer  to  the  PDL  Model  Document  Release  1.0  [CARDS93]. 

The  Model  is  being  iteratively  developed  by  the  Central  Archive  for  Reusable  Defense  Software 
(CARDS)  Program.  The  Model  is  enhanced  to  reflect  new  information,  new  documentation,  and 
new  releases  of  existing  documentation.  Subsequent  releases  of  the  PDL  will  be  accompanied 
by  updates  to  this  Guide. 

1.1  Background 

The  Generic  Command  Center  (GCC)  project  (the  forerunner  of  PRISM)  integrated  components 
for  use  in  command  centers. 

'The  Generic  Command  Center  Phase  2  prototype  is  an  implementation  of  a  portion  of  the 
Generic  Command  Center  (GCC)  architecture .  The  purpose  of  this  prototype  is  to  validate 
the  concept  of  building  command  centers  by  integrating  large  reusable  components. 

The  required  functionality  is  that  of  processing...  messages;  establishing  a  database; 
displaying  information  in  a  geographic  information  system;  creating  tables  of  information; 
and  creating  briefings  that  interface  with  the  database.  The  implementation  was  consistent 
with  the  GCC  architecture  and  used  several  commercial  off-the-shelf  (COTS)  products  as 
components...  The  results  of  the  GCC  Phase  2  are  extremely  promising  toward  the  concept 
feasibility  of  integrating  large  software  components  for  application  in  the  Command 
Center  domain."  [ESD92] 

PRISM,  which  took  over  from  GCC  in  January  1992,  has  an  ambitious  goal  of  "fleshing 
out"  a  real  generic  architecture  for  command  centers.  PRISM  proposes  to  provide  users  with 
80%  of  the  required  resources  to  produce  a  new  command  center  as  well  as  information  on 
acquiring  or  producing  the  remainder.  The  CARDS  library  models  are  incrementally  encoding 
and  disseminating  information  generated  by  PRISM. 

1.2  Notation  Used  in  this  Document 

This  Guide  describes  procedures  to  interact  with  the  UNIX  operating  system  through  a  UNIX 
shell  interpreter.  Therefore,  examples  are  given  that  sometimes  use  a  special  notation.  In 
presenting  the  examples,  the  following  notation  is  used: 

%  -  the  UNIX  shell  prompt  (is  system  dependent). 

<user_supplied_information>  -  user-supplied  information  where  "user_supplied_information"  is 
the  descriptive  keyword(s)  you  replace  with  text  without  the  angled  brackets. 
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text  -  the  text  you  type. 

[Quit]  -  a  graphical  command  choice  or  menu  option. 

Example,  %  Browser 

you  would  not  type  the  percent  sign  which  is  the  UNIX  shell  prompt;  you  would  insert  the 
name  of  a  text  editor  of  your  choice,  such  as  vi  or  emacs  in  place  of  "editor";  but  you  would 
type  the  file  name  "Browser"  as  shown:  %  vi  Browser 

13  Requirements 

The  Model  is  run  from  Fairmont,  WV,  either  remotely  via  AFS  or  remotely  via  Internet.  Different 
library  access  methods  have  different  hardware  and  software  requirements. 

The  assumptions  and  constraints  are  listed  according  to  access  method. 

13.1  Running  Remotely  via  AFS 

To  execute  the  Model  operational  software  on  the  user’s  machine,  it  is  necessary  to: 

•  Have  a  CARDS  user  AFS  account. 

•  Have  a  Sun  4  Architecture  workstation  with  SunOS  4.1.1  or  higher. 

•  Be  running  AFS  and  have  the  CARDS  cell  cards.com  mounted  on  the  user’s 
machine. 

•  Be  running  the  Motif  window  manager  (mwm),  v  1.1  or  higher,  under  XI 1  R4  or 
Xll  R5. 

NOTE:  When  you  obtain  a  CARDS  account,  you  will  get  a  CARDS  AFS  account  for  you  to 
"klog"  into  the  CARDS  library. 

13.2  Running  Remotely  via  Internet 

To  execute  the  Model  operational  software  on  the  CARDS  facility  machine  and  display  on  the 
user’s  local  workstation,  it  is  necessary  to: 

•  Have  a  CARDS  user  UNIX  account. 

•  Have  a  CARDS  user  AFS  account. 

•  Have  an  Internet  Connection. 
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•  Be  running  the  Motif  window  manager  (mwm),  vl.l  or  higher,  under  XI 1  R4  or 
XI 1  R5  on  the  user’s  local  machine. 

1.4  Accounts/Problems 

To  obtain  a  CARDS  account,  to  get  help  and  information,  or  report  a  problem,  please  contact: 
CARDS 

1401  Country  Club  Road,  Suite  201 
Fairmont,  WV  26554-1304 
Phone:  (800)  828-8161,  (304)  367-0421 
FAX:  (304)  363-0775 
email:  hotline@cards.com 

1.5  X  Window  System 

The  X  Window  System  is  a  network  transparent  window  system  developed  at  MIT  which  runs  on 
a  wide  range  of  machines.  An  X  server  and  window  manager  must  be  running  on  the  machine 
on  which  a  CARDS  operational  library  is  being  displayed.  The  X  Window  System  version 
must  be  XI 1  R4  or  XI 1  R5.  For  more  information  on  the  X  Window  System,  contact  the  MIT 
Software  Center  at  the  X  Hotline:  (617)  258-8330.  X  Window’s  source  code  is  available  on 
export.les.mit.edu  via  anonymous  ftp. 

1.6  Internet 

Internet  is  a  collection  of  networks  around  the  world  linking  research,  university,  and  military 
sites.  Millions  of  computers,  through  the  use  of  TCP/IP  standards,  become  an  electronic 
community.  Once  you  are  a  member  of  the  community,  you  can  have  access  to  a  vast 
information  base.  The  only  cost  is  the  network  connection  itself.  For  more  information  about 
Internet  contact: 

SURANET 

8400  Baltimore  BlvdL,  Suite  101 
College  Park,  MD  20740-2496 
Phone:  (800)  787-2638 
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2  GETTING  STARTED 

Access  to  a  Model  operational  software  is  provided  via  the  CARDS  operational  software  located 
under  the  AFS  "cards.com"  cell  on  the  CARDS  facility  machine  in  Fairmont,  WV. 

If  the  user  has  access  to  a  Sun  4  Architecture  workstation  running  Motif  window  manager  (mwm) 
under  XI 1  R4  or  XI 1  R5,  and  AFS  with  the  cards.com  cell  mounted,  the  Model  operational 
software  should  be  run  (remotely  via  AFS)  directly  on  the  user’s  machine. 

If,  however,  the  user  does  not  have  access  to  AFS  with  the  cards.com  cell  mounted  or  does 
not  have  a  Sun  4  Architecture  workstation,  but  can  run  an  XI 1  R4orXll  R5  server  and  the 
Motif  window  manager  (mwm),  it  is  possible  to  run  the  Model  operational  software  (remotely 
via  Internet)  on  the  CARDS  facility  machine. 

2.1  Running  Remotely  via  AFS. 

1.  Log  into  a  Sun  4  Architecture  workstation. 

2.  Start  X  Window  using  the  Motif  window  manager  (mwm).  If  "/afs/cards.com/bin"  is 
not  in  your  path,  add  it  now  (see  Appendix  A). 

3.  Pull  up  any  one  of  the  following  windows: 

•  command  window. 

•  shell  tool. 

•  xterm  window. 

•  console  window. 

4.  Authenticate  yourself  to  AFS: 

%  klog  -prin  <CARDS_AFS_user_name>  -cell  cards.com 

•  For  example,  if  AFS  user  "smith"  is  running  from  a  remote  site,  the  command 
would  look  lixe:  %  klog  -prin  smith  -cell  cards.com 

•  NOTE:  If  the  user’s  home  machine  is  a  CARDS  facility  machine,  the  klog  com¬ 
mand  can  be  used  by  itself  to  log  into  the  CARDS  user  AFS  account:  %  klog 

•  The  user  will  then  be  prompted  for  the  password  as  follows: 

Password:  <CARDS_AFS_user_password> 
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5.  Check  (optional)  to  see  if  you  are  klog’ed:  %  tokens 

•  If  there  is  not  a  token  for  afs@cards.com,  then  you  did  not  klog  into  cards.com 
(go  back  to  step  4). 

6.  Run  the  RLF  Graphical  Browser:  %  rungb 
2.2  Running  Remotely  via  Internet 

1.  Log  into  your  machine. 

2.  Start  X  Window  using  the  Motif  window  manager  (mwm). 

3.  Pull  up  any  one  of  the  following  windows: 

•  command  window. 

•  shell  tool. 

•  xterm  window. 

•  console  window. 

4.  Record  your  machine’s  IP  address:  %  arp  <your_machine_name> 

•  For  example,  if  your  machine’s  name  is  blakjack,  the  arp  command  would  return 
your  machine’s  name  followed  by  it’s  IP  address  in  parenthesis  as: 

blakjack  (188.183.40.5) 

5.  Allow  the  RLF  Graphical  Browser  to  display  on  your  machine  using  the  CARDS  IP 
address:  %  xhost  +  192.133.70.4 

6.  Connect  to  the  CARDS  Library:  %  telnet  192.133.70.4 

•  NOTE:  You  should  now  be  connected  to  the  CARDS  facility  machine  called 
Solitaire.  Sometimes  user  logins  are  transferred  to  another  CARDS  facility 
machine,  such  as  Dealer,  the  functionality  is  the  same. 

7.  Log  into  the  CARDS  facility  machine  (Solitaire): 

a.  Login:  <CARDS_UNIX_user_name> 

b.  The  user  will  then  be  prompted  for  the  UNIX  password  as  follows: 
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Password:  <CARDS_UNTX_user_password> 

c.  The  user  will  then  be  prompted  for  the  APS  password  as  follows: 

Password:  <CARDS_AFS_user_password> 

d.  NOTE:  If  you  were  not  prompted  for  the  Password,  you  will  have  to"  klog"  (see 
step  4  in  the  previous  section  "Running  Remotely  via  AFS"). 

8.  Check  (optional)  to  see  if  you  are  klog’ed:  %  tokens 

If  there  is  not  a  token  for  "afs@cards.com",  then  you  did  not  successfully  klog 
into  cards.com.  You  will  now  have  to  "klog"  (see  step  4  in  the  previous  section 
"Running  Remotely  via  AFS."). 

9.  Set  the  environment  so  the  RLF  Graphical  Browser  can  be  displayed  on  your 
machine: 

•  If  you  are  using  the  C  shell  (csh): 

%  setenv  DISPLAY  <your_machines_IP_address>:0.0 

•  If  you  are  using  the  Bourne  shell  (sh)  or  Korn  shell  (ksh): 

%  DISPLAY =<your_machine  ’  s_IP_address>:0.0 
%  export  DISPLAY 

10.  Run  the  RLF  Graphical  Browser:  %  rungb 
23  Library  Startup 

To  access  the  library,  perform  the  following: 

1.  Select  the  library  option  from  the  "Choose  a  Library"  pull-down  menu,  e.g.,  "PRISM 
Documentation  vl.O". 

2.  Select  the  "Enter  Library"  option  through  the  "Choose  a  Command”  pull-down  menu. 

3.  Select  the  "OK"  button  to  enter  the  choosen  library. 
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APPENDIX  A  •  Modifying  Path  Variable 
A.1  Modifying  the  C  Shell  "path"  Variable 

If  the  C  shell  (csh)  is  used,  the  "/afs/cards.com/bin"  directory  can  be  placed  in  the  command 
search  path  by  modifying  the  C  shell  "path"  variable  either  temporarily  or  permanently. 

To  see  if  "/afs/cards.com/bin"  is  already  in  your  path:  %  echo  $path 

The  "/afs/cards.com/bin"  directory  can  be  temporarily  placed  in  the  command  search  path  by 
modifying  the  C  shell  "path"  variable.  This  can  be  done  by  issuing  the  following  command  at 
the  C  shell  prompt:  %  set  path=(/afs/cards.com/bin  $path) 

This  command  will  add  directory  "/afs/cards.com/bin"  to  the  current  command  search  path. 
However,  this  update  is  temporary  (when  the  current  shell  is  exited,  this  modification  is  lost). 

The  "/afs/cards.com/bin"  can  be  permanently  placed  in  the  command  search  path  by  editing  the 
C  shell  initialization  file  (named  ".cshrc")  in  the  user’s  home  directory.  This  is  accomplished  by 
inserting  the  following  line  into  the  ".cshrc”  file  in  the  user’s  home  directory: 

set  path=(/afs/cards.com/bin  $path) 

where  $path  is  the  shell  variable  containing  the  current  command  search  path. 

Alternatively,  the  "/afs/cards.com/bin"  directory  can  be  added  to  an  existing  "set  path"  statement 
in  the  ".cshrc"  file.  Since  the  C  shell  reads  the  ".cshrc"  file  each  time  it  is  started,  these  variable 
settings  are  effectively  permanent  until  the  ".cshrc"  file  is  edited  again. 

The  "source"  command  is  a  valuable  tool  for  working  in  the  current  shell  environment.  When 
the  "source"  command  is  invoked,  the  C  shell  reads  and  executes  the  commands  in  the  specified 
file.  Since  no  new  subshell  is  created,  the  "source"  command  can  be  run  specifying  the  ".cshrc" 
file  to  modify  the  current  shell  environment  without  having  to  exit  the  current  C  shell  and  start  a 
new  C  shell.  Therefore,  after  the  ".cshrc"  file  has  been  properly  updated,  the  following  command 
can  be  used  to  update  the  current  shell  environment:  %  source  ~  /.cshrc 

where  tilde  (  “  )  is  expanded  by  the  C  shell  to  be  the  path  to  the  user’s  home 
directory. 

A.2  Modifying  the  Bourne  Shell  "PATH"  Variable 

If  the  Bourne  shell  (sh)  is  used,  the  "/afs/cards.com/bin"  directory  can  be  placed  in  the  command 
search  path  by  modifying  the  Bourne  shell  "PATH"  variable  either  temporarily  or  permanently. 

To  see  if  "/afs/cards.com/bin"  is  already  in  your  path:  %  echo  $PATH 

The  "/afs/cards.com/bin"  directory  can  be  temporarily  placed  in  the  command  search  path  by 
modifying  the  Bourne  shell  "PATH"  variable.  This  can  be  done  by  issuing  the  following 
command  at  the  Bourne  shell  prompt: 
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$  PATH=/af s/cards. com/bin : $P ATH ;  export  PATH 

This  command  adds  the  directory  "/af s/cards. com/bin"  to  the  current  command  search  path. 
However,  this  update  is  temporary  (when  the  current  shell  is  exited,  this  modification  is  lost). 

The  "/afs/cards.com/bin"  can  be  permanently  placed  in  the  command  search  path  by  editing 
the  Bourne  shell  initialization  file  (named  ".profile")  in  the  user’s  home  directory.  This  is 
accomplished  by  inserting  the  following  line  into  the  ".profile"  file  in  the  user’s  home  directory: 

PATH=/afs/cards.com/bin:$PATH;  export  PATH 

where  $PATH  is  the  shell  variable  containing  the  current  command  search  path. 

Alternatively,  the  "/afs/cards.com/bin"  directory  can  be  added  to  an  already  existing  "PATH=" 
statement  in  the  ".profile"  file.  Since  the  Bourne  shell  reads  the  ".profile"  file  each  time  it  is 
started,  the  variable  settings  are  effectively  permanent  until  the  ".profile"  is  edited  again. 

The  "."  command  is  similar  to  the  C  shell  "source"  command  and  can  be  used  to  update  the 
current  shell  environment  with  the  modifications  made  to  the  ".profile"  file  without  having  to 
exit  the  current  Bourne  shell  and  startup  a  new  shell.  Thus,  after  the  ’’.profile"  file  has  been 
properly  updated,  the  following  command  can  be  used  to  update  the  current  shell  environment: 

%  .$HOME/.profile 

where  SHOME  is  expanded  by  the  Bourne  shell  to  the  user’s  home  directory. 
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